﻿
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!-- saved from url=(0014)about:internet -->
<html xmlns:msxsl="urn:schemas-microsoft-com:xslt" xmlns:mssdk="winsdk" xmlns:script="urn:script" xmlns:build="urn:build" xmlns:MSHelp="http://msdn.microsoft.com/mshelp">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<meta name="Description" content="A dollar sign followed by a pair of braces ( ${ } ) evaluates to a variety of values related to the specified user-named alias."/>
<meta name="MSHAttr" content="PreferredSiteName:MSDN"/>
<meta name="MSHAttr" content="PreferredLib:/library/windows/hardware"/>
<title>${ }  (Alias Interpreter)</title>

<meta name="MS-HAID" content="r14_tokens_6d97cf2f-9194-42d4-a7bb-b7316c117802.xml"/>


<link rel="STYLESHEET" type="text/css" HREF="../common/backsdk4.css"/>





<style>
html,div { margin: 0; padding: 0;}

body {
	padding: 0px;
	margin: 0px;
	overflow: auto;
	height: 100%;
}

#winchm_template_button{
	float: right;
	width: 93px;
	top: 7px;
	position: relative;
	text-align: right;
	right: 5px;
	height: auto;
}

#winchm_template_top{
	padding: 0px;
	margin: 0px;
	border-bottom: 1px solid #9B9B9B;
	background-color: #B1CEFE;
}

#winchm_template_navigation{
	margin: 0px;
	padding-top: 7px;
	padding-left: 7px;
	padding-bottom: 3px;
	padding-right: 0px;
	font-size: 8.5pt;
	font-family: Arial, Helvetica, sans-serif;
	font-weight: normal;
	color: #585858;
}

#winchm_template_title{
	margin: 0px;
	padding-top: 4px;
	padding-left: 7px;
	padding-bottom: 7px;
	padding-right: 0px;
	font-size: 18px; 
	font-family: Verdana, Geneva, sans-serif;
	color: #363636;
}

#winchm_template_content{
	margin-top: 20px;
	margin-left: 15px;
	margin-bottom: 20px;
	margin-right: 15px;
	width: auto  !important;
	width: 100%;
}

#winchm_template_footer{
	border-width: 1px;
	border-color: #B1CEFE;
	border-top-style: solid;
	margin-top: 15px;
	margin-left: 15px;
	margin-bottom: 20px;
	margin-right: 15px;
	padding-top: 7px;
	padding-left: 0px;
	padding-bottom: 0px;
	padding-right: 0px;
	font-family: arial, helvetica, sans-serif;
	font-size: 8.5pt;
	color: #696969;
	width: auto;
	text-align: left;
}


#winchm_template_container{
	margin: 0px;
	padding: 0px;
	position: static;
	padding-bottom: 3px;
	overflow: auto;
	background-color: #FFFFFF;
}


@media print
{
#winchm_template_container{
	position: static;	
	margin: 0px;
	padding: 5px;
	
	width: auto;
	height: auto;
	overflow: auto;
}
#winchm_template_button{
visibility:hidden;
}
}

#winchm_template_navigation A:link	{text-decoration: none; color:#004080}
#winchm_template_navigation A:visited  {text-decoration: none; color: #004080}
#winchm_template_navigation A:active {text-decoration: none; color: #004080 }
#winchm_template_navigation A:hover {text-decoration: none;color: #0080FF}

A:link	{text-decoration: underline; color:#0033CC}
A:visited  {text-decoration: underline; color: #0033CC}
A:active {text-decoration: underline; color: #0033CC }
A:hover {text-decoration: underline;color: #FF0000;}
</style>
<script type="text/javascript">
function isMobile(){
Agent = window.navigator.userAgent;
if (Agent.indexOf("iPhone")>=1 || Agent.indexOf("iPad")>=1 || Agent.indexOf("iPod")>=1 || Agent.indexOf("Android")>=1){
return true;
}else{
return false;	
}

}
function d_onresize(){
if (window.navigator.userAgent.indexOf("MSIE")>=1){
document.getElementById('winchm_template_container').style.pixelWidth = document.body.offsetWidth - 3;
document.getElementById('winchm_template_container').style.pixelHeight = document.body.offsetHeight - document.getElementById('winchm_template_top').offsetHeight - 4;
}
document.getElementById('winchm_template_container').style.top = document.getElementById('winchm_template_top').offsetHeight + 'px';
}

function d_onbeforeprint(){
document.getElementById('winchm_template_container').style.width = 'auto';
document.getElementById('winchm_template_container').style.height = 'auto';
}

function d_onafterprint(){
d_onresize();
}

if(!isMobile()){

window.onload = d_onresize;
window.onresize = d_onresize;
window.onbeforeprint = d_onbeforeprint;
window.onafterprint = d_onafterprint;

document.write("<style>\n");
document.write("body {overflow: hidden;}\n");
document.write("#winchm_template_container {position: absolute;overflow: auto;top : 0px;right: 0px;bottom: 0px;left: 0px;}\n");
document.write("</style>\n");
}

</script>
</head>
<body><script language="JavaScript" type="text/JavaScript">
function syn(){
if(parent.nav.tree){
 if(parent.nav.tree.loaded){
  parent.nav.tree.selectNode(1935);
 }else{
  setTimeout("syn()",500);
}
  }else{
  setTimeout("syn()",500);
  }}
if(parent!=self){
  setTimeout("syn()",100);
}else{
  parent.location.href = "../../index.htm?page=debugger/_______alias_interpreter_.htm";
}
originalOnload = window.onload;
if(originalOnload==null){
window.onload = function(){parent.contentLoaded = true;};
}else{
window.onload = function(){originalOnload();parent.contentLoaded = true;};
}
</script> 


<div id="winchm_template_top">
	<div id="winchm_template_button"><A href="______block_delimiter_.htm" title="Previous topic"><img id="winchm_template_prev" alt="Previous topic" src="../template2/btn_prev_n.gif" border="0"></a><A href="_____comment_specifier_.htm" title="Next topic"><img id="winchm_template_next" alt="Next topic" src="../template2/btn_next_n.gif" border="0"></a></div>
	<div id="winchm_template_navigation">Help &gt; 
<A href="introduction6.htm">Debugging Tools for Windows (WinDbg, KD, CDB, NTSD)</A> &gt; <A href="debugger_reference.htm">Debugger Reference</A> &gt; <A href="debugger_commands.htm">Debugger Commands</A> &gt; <A href="command_tokens.htm">Command Tokens</A> &gt; </div>
	<div id="winchm_template_title">${ }  (Alias Interpreter)</div>
</div>
<div id="winchm_template_container">
	<div id="winchm_template_content"><div id="mainSection"><p>A dollar sign followed by a pair of braces ( <b>${ }</b> ) evaluates to a variety of values related to the specified user-named alias.</p>
<pre class="syntax"><i>Text </i><b>${</b><i>Alias</i><b>} </b><i>Text</i> 
<i>Text </i><b>${/d:</b><i>Alias</i><b>} </b><i>Text</i> 
<i>Text </i><b>${/f:</b><i>Alias</i><b>} </b><i>Text</i> 
<i>Text </i><b>${/n:</b><i>Alias</i><b>} </b><i>Text</i> 
<i>Text </i><b>${/v:</b><i>Alias</i><b>} </b><i>Text</i> 
</pre>
<h2><a id="ddk_token_alias_interpreter_dbg"></a><a id="DDK_TOKEN_ALIAS_INTERPRETER_DBG"></a>Parameters</h2>
<p></p>
<dl>
<dt><a id="Alias"></a><a id="alias"></a><a id="ALIAS"></a><i>Alias</i></dt>
<dd>
<p>Specifies the name of the alias to be expanded or evaluated. <i>Alias</i> must be a user-named alias or the <i>Variable</i> value used by the <a href="#Bookmark1946"><b>.foreach</b></a> token.</p>
</dd>
<dt><a id="_d"></a><a id="_D"></a><b>/d</b></dt>
<dd>
<p>Evaluates to one or zero depending on whether the alias is currently defined. If the alias is defined, <b>${/v:</b><i>Alias</i><b>}</b> is replaced by 1; if the alias is not defined, <b>${/v:</b><i>Alias</i><b>}</b> is replaced by 0.</p>
</dd>
<dt><a id="_f"></a><a id="_F"></a><b>/f</b></dt>
<dd>
<p>Evaluates to the alias equivalent if the alias is currently defined. If the alias is defined, <b>${/f:</b><i>Alias</i><b>}</b> is replaced by the alias equivalent; if the alias is not defined, <b>${/f:</b><i>Alias</i><b>}</b> is replaced by an empty string.</p>
</dd>
<dt><a id="_n"></a><a id="_N"></a><b>/n</b></dt>
<dd>
<p>Evaluates to the alias name if the alias is currently defined. If the alias is defined, <b>${/n:</b><i>Alias</i><b>}</b> is replaced by the alias name; if the alias is not defined, <b>${/n:</b><i>Alias</i><b>}</b> is not replaced but retains its literal value of <b>${/n:</b><i>Alias</i><b>}</b>.</p>
</dd>
<dt><a id="_v"></a><a id="_V"></a><b>/v</b></dt>
<dd>
<p>Prevents any alias evaluation. Regardless of whether <i>Alias</i> is defined, <b>${/v:</b><i>Alias</i><b>}</b> always retains its literal value of <b>${/v:</b><i>Alias</i><b>}</b>.</p>
</dd>
</dl>
<h3><a id="Additional_Information"></a><a id="additional_information"></a><a id="ADDITIONAL_INFORMATION"></a>Additional Information</h3>
<p>For an explanation of how to use aliases, see <a href="#Bookmark1268">Using Aliases</a>.</p>
<h2>Remarks</h2>
<p>If no switches are used and the alias is currently defined, <b>${</b><i>Alias</i><b>}</b> is replaced by the alias equivalent. If no switches are used and the alias is not defined, <b>${</b><i>Alias</i><b>}</b> always retains its literal value of <b>${</b><i>Alias</i><b>}</b>.</p>
<p>One advantage of using the <b>${ }</b> token is that the alias will be evaluated even if it is adjacent to other characters. Without this token, the debugger only replaces aliases that are separated from other tokens by a space.</p>
<p>As indicated, there are circumstances where the <b>${ }</b> token is not replaced by anything but retains its literal value. This occurs when no switch is used and <i>Alias</i> is undefined, when the <b>/n</b> switch is used and <i>Alias</i> is undefined, and always when the <b>/v</b> switch is used. In these circumstances, the token retains its literal value, including the dollar sign and the braces. Therefore, if this is used as the parameter of a command, a syntax error will result, unless that parameter accepts arbitrary text strings.</p>
<p>There is, however, one exception to this. If you use <b>${/v:</b><i>Alias</i><b>}</b> as the first parameter to the <a href="#Bookmark1974"><b>as (Set Alias)</b></a> or <b>aS (Set Alias)</b> command, this token will be treated as the string <i>Alias</i> alone, not as the string <b>${/v:</b><i>Alias</i><b>}</b>. This only works with the <b>as</b>, <b>aS</b>, and <b>ad</b> commands, and it only works when the <b>/v</b> switch is used&#8212;it will not work with <b>${/n:</b><i>Alias</i><b>}</b> or <b>${</b><i>Alias</i><b>}</b> when they retain their literal values.</p>
<p><i>Alias</i> must be a user-named alias or the <i>Variable</i> value used by the <a href="#Bookmark1946"><b>.foreach</b></a> token&#8212;not a fixed-name alias. If there is a fixed-name alias within the string <i>Alias</i>, it will be replaced before the <b>${ }</b> token is evaluated.</p></div></div>	
	<div id="winchm_template_footer">Copyright &copy; 2019. All rights 
reserved. (To change the copyright info, just edit it in template.)</div>
</div>

</body>
</html>
